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1. Introduction 



This manual describes how to program the appearance and functionality of 
file icons in the IRIS™ Workspace™ environment. This manual should 
enable you to customize existing icons, as well as add your own unique 
icons to the IRIS Workspace. 



1.1 What Does Workspace Do? 

The IRIS Workspace presents a sophisticated icon-based interface to the 
IRIX™ file system and operating system. Icons in the IRIS Workspace 
represent files; the various ways that you can act upon these icons, such as 
double-clicking on them with the mouse cursor, invoke IRIX command 
lines as if they had been typed in a shell. Thus, the Workspace allows you 
to perform sophisticated operations on IRIX files entirely through its 
graphical interface. 



1.2 What Is File Typing? 

The IRIS Workspace manages the numerous varieties of IRIX files and the 
actions that are associated with them using a process called file typing. 
There a potentially unlimited number of possible file types that can exist 
within the IRIX file system: plain text files, formatted documents, 
directories, shell scripts, images, and binary executables, to name only a 
few. Every type of file has an associated set of operations, often unique, that 
a user would most often want to perform on the files. The file type 
declarations and associated rules that give each type of file a unique 
appearance and behavior under the Workspace are collectively called file 



Version 1.0 Introduction 1-1 



1.5 Transfer Devices 

This manual also describes how to create transfer devices. Transfer devices 
are special shell scripts that move data into and out of a directory, and are 
accessed as commands under the * Transfer' • submenu in the Workspace 
and Directory View menus. End users can select transfer devices by 
selecting the Transfer Manager from the System toolchest. Possible transfer 
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typing rules. The syntax of these rules is discussed in Chapter 2. An 
additional set of rules define the preferred method of sending a file of a 
particular type to a user-specified printer. These rules are called print 
conversion rules, and are discussed in Chapter 3. 



13 FTR Files 

File typing rules determine how files behave within the IRIS Workspace. 
Print conversion rules determine how file types defined by the typing rules 
are convened to printed output. Both kinds of rules are read by Workspace 
from compiled versions of special text files called FTR files. An FTR source 
file ends with the suffix fir, and must reside in one of four subdirectories 
found in lusrllihlfilelype. Section 2.10, "Compiling FTR Rules", discusses 
which of these subdirectories is appropriate for your FTR files, and how to 
compile them into versions that can be understood by Workspace. 



1-4 Workspace Templating ( 

Workspace templating allows you to create configurations of icons in the 
Workspace window that will appear for all Workspace users on a system. 
Workspace templates are maintained in lusrl lib/workspace; each template 
installed in this directory has an additive effect on existing templates, so a 
user of several software packages written for use with Workspace can have 
the benefit of each package's template. Workspace templating is described 
in Chapter 4. 



( 



devices include scripts that archive selected files to and from tape, copy 
selected files to and from remote machines, or mail selected files to other 
users. Transfer devices can move data locally or over the network, 
depending on how they are implemented. They are discussed in detail in 
Chapter 5. 
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2. Writing Fiie Typing Rules 



File typing rules determine how a file of a particular type will appear within 
the IRIS Workspace, and also define what functions you can perform on the 
file by double-clicking on it or choosing menu items that manipulate it. The 
IRIS Workspace uses the file typing rules to evaluate all files that are 
presented within the Workspace or any Directory View window. 

There are several reasons why you might want want to write file typing 
rules. You might wish to customize the look of Workspace icons or modify 
what happens to the files they represent when you manipulate them. Or, you 
might want to create unique Workspace icons when you are developing an 
application and its associated data files. In either case, you need to write file 
typing rules to accomplish your goal. 

File typing rules are similar in some ways to shell scripts. In fact, several of 
the rules are simply sets of Bourne shell commands (see sh(l)). File typing 
rules consist of a type declaration, which identifies a unique file type, and a 
set of up to seven rules following the declaration. All rules, including the 
type declaration, consist of a rule key followed by the rule itself. Rules can 
be multi-line, but continuation lines cannot begin with any of the rule keys. 
Table 2-1 below gives a brief summary of the rule keys and what each 
associated rule is used for. 

The remaining sections of this chapter describe each of the file typing rules 
in detail, and offer suggestions for good file typing style and strategies. 
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FH® Typing Rule Key Function 



TYPE 
MATCH 

LEGEND 
SUPERTYPE 

SPECIALFILE 

CMD OPEN 
CMDALTOPEN 
CMD DROP 
CMD PRINT 

MENUCMD 



BOUNDS 
ICON 



Declares a new type. 

Lets Workspace determine if a file is of the declared 

type. 

Provides a text description of the file type. 

Tells Workspace to treat the file as a subset of a 
another type under certain circumstances. 

Tells Workspace that the file typing rule is to be used 
only on non-plain files. 

Defines a series of actions that occur when the mouse 
is double-clicked on an icon. 

Defines a series of actions that occur when the mouse 
is alt-double-clicked on an icon. 

Defines a series of actions that occur when you 
"drop" an icon on top of another. 

Defines a series of actions that occur when you 
choose "Print" from the Workspace or Directory 
View menus. 

Defines menu entries and actions that are inserted 
into the Workspace or Directory View menus when 
an icon is selected. 

Defines the coordinate space for the file type's icon. 

Defines the appearance (geometry) of the file type's 
icon. 
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2.1 The TYPE Declaration 



Syntax: TYPE type-name 

Description: type-name is a one word ASCII string. Legal type names can 
be any legal C language variable name. You should ideally 
choose a name that is in some way descriptive of the file type 
it represents. All rules that follow a TYPE declaration apply 
to that type, until the next TYPE declaration is encountered 
in the FTR file. Each TYPE declaration must have a unique 
type name. 

Example: TYPE GenericExecutable 



2.2 The MATCH Rule 



Syntax: 



MATCH match-expression; 



Description: match-expression is a logical expression that should evaluate 
to true if and only if a file is of the type declared by TYPE. 
The match-expression must consist only of valid MATCH 
functions, as described Section 2.2.1. The match-expression 
can use multiple lines, but must terminate with a semicolon 
(;). Multiple match-expressions are not permitted for a given 
type. The MATCH rule is employed each time a file is 
encountered by the Workspace, to assign a type to that file. 

Example: MATCH glob("*.h") && ascii; 
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2.2.1 Valid Match-Expressions 

This section describes the syntax and function of valid match-expressions. 

Operators, Constants, and Numerical Representation 

The following C language operators can be used in a match-expression: 

+ - * / & | A ! % ( ) 

The following C language conditional operators can be used in a match- 
expression: 

&& || ==!=<> <= >= 

The '==' operator works for string comparisons in addition to numerical 
comparisons. 

The following constants can be used in a match-expression: 

true false 

Numbers in match-expressions can be represented in decimal, octal, or 
hexadecimal notation. Table 2-2 describes these representations. 



Representation Syntax 

decimal num 

octal Onum 

hexadecimal Qxnurn 



Table 2-2. Numerical Representations in Match-Expressions 

Functions 

Table 2-3 describes the set of valid match-expression functions. 



c 
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Function Syntax 



Definition 



ascn 
char (n) 

dircontains ("string") 
glob ("string") 



linkcount 
long (n) 

mode 

print (expr or "string" ) 



short (n) 

size 
string (n 9 m) 

uchar (n) 

tag 

ushort (n) 



Returns TRUE if the first 512 bytes of the file are all 
printable ASCII characters. 

Returns the nth byte in the file as a signed character; 
range -128 to 127. 

Returns TRUE if the file is a directory and contains 
the file named by string. 

Returns TRUE if the file's name matches string; 
allows use of the following expansions in string for 
pattern matching: {}[]*? and backslash (see 
sh(l) file name expansion). 

Returns the number of hard links to the file. 
Returns the nth byte in the file as a signed long 
integer; range -2 31 to 2 31 - 1. 

Returns the mode bits of the file (see chmod(l)). 

Prints the value of the expression expr or string to 
stdout each time the rule is evaluated; used for 
debugging. Always returns true. 

Returns the nth byte of the file as a signed short 
integer; range -32768 to 32767. 

Returns the size of the file in bytes. 

Returns a string from the file that is m bytes 
(characters) long, beginning at the nth byte of the file. 

Returns the nth byte of the file as an unsigned 
character; range to 255. 

Returns the specific Workspace application tag 
injected into an executable file by the tag injection 
tool (see tag(l) in Appendix B, * 'Workspace Man 
Pages"). Returns -1 if the file is not a tagged file. 
Returns the nth byte of the file as an unsigned short 
integer; range to 65535. 



Table 2-3. Match-Expression Functions 



Version 1.0 



Writing File Typing Rules 2-5 



2.2,2 Building Effective MATCH Rules 

A match rule consists of a sequence of expressions, each of which checks a 
file for positive distinguishing characteristics. The most effective way to 
order these expressions in a single MATCH rule is to choose a set of 
expressions, each of which tests for a single characteristic, and conjoin them 
all using "and" conditionals (&&). 

The order in which the expressions in a MATCH rule are conjoined may 
have an effect on the efficiency of the rule's evaluation. You should always 
try to order the expressions so that the maximum number of files are 
"weeded out" by the first expressions. The reason for this is that, as in the 
C language, && will stop evaluation as soon as one side of the conditional 
is found to be false. Therefore, as a rule of thumb, the more likely an 
expression is to be false, the further to the left of the MATCH rule you 
should place it. 

For example, one possible way to match a C source file is with the following 
rule: 

MATCH glofo("*„G") && ascii; 

Note that it is more efficient to place the glob ( " * . c " ) expression first 
because there are many more files that do not end in x than there are files 
that are not ASCII text. 

You should also make sure that your match rule is specific enough not to 
"catch" any unwanted files. FTR files are scanned sequentially (see 
Section 2.10, "Compiling FTR Rules"), so if you define a type with the 
following MATCH rule at the beginning of the FTR file, 

TYPE foo 

MATCH ascii; 

every text file in your system will be defined as a file of type "foo". 



2.2.3 Tagging Executabies 

The preferred way to match a specific executable to a file typing rule is to 
"tag" it with a unique 32-bit number. tag{\) allows you to inject a 32-bit 
tag safely into a shell script or MIPS executable, where it can be read by a 
MATCH rule using the tag match-expression function (see Table 2-2). 
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The upper 16 bits of the tag number are reserved for vendor ID, and are 
administered by Silicon Graphics, Inc. The lower 16 bits are for general 
use. Anyone planning to create file typing rules as part of a commercial 
software release is strongly encouraged to obtain a vendor ID. 



Number Semantics 

0x00000000 windowed executable (no tty window needed) 

0x00000100 generate a launch window for argument input 

0x00000200 generate an output-only tty window 

0x00000400 generate a tty window for input and output 

0x00000000 no arguments 

0x00000001 one argument 

0x0000 0002 two arguments 

0x0 0000004 three arguments 

0x0 00 0008 zero or one argument 

0x00000010 zero or more arguments 

0x00000020 one or more arguments 

Table 2-4. Tag Numbers for IRIX Executables 

Silicon Graphics, Inc., has defined a tag numbering scheme and a set of 
TYPE rules for standard IRIX executables that make use of these 32-bit 
values. Table 2-4 lists the various tag numbers and what actions they 
anticipate. These numbers are combined via bitwise-OR to create the tag 
numbers used in the standard IRIX executable TYPEs listed below with 
their associated MATCH rules. 

TYPE GenericWindowedExecutable 

MATCH tag == 0x00000000; 

TYPE ttyOutl-NargExecutable 

MATCH tag.™ 0x00000620; 

TYPE ttyLaunchExecutable 

MATCH tag == 0x00000500; 

TYPE ttyOutExecutable 

MATCH (tag == 0x00000600) || (tag == 0x00000610); 

TYPE ttyLaunchOutExecutable 

MATCH (tag == 0x00000700) || (tag == 0x00000710); 

TYPE ttyLaunchOutl-NargExecutable 
MATCH tag == 0x00000720; 
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TYPE ttyExecutable 

MATCH (tag == 0x00000400) || (tag — 0x00000410); 

TYPE LaunchExecutable 

MATCH tag ~ 0x00000100; 

TYPE ttyLaunchl-NargExecutable 

MATCH tag == 0x00000520; 

TYPE ttyOut2argExecutable 

MATCH tag == 0x00000602; 

TYPE Genericl-NargExecutable 

MATCH tag == 0x00000020; 

TYPE ttyLaunchOutlargExecutable 

MATCH tag -- 0x00000701; 

TYPE ttyl-NargExecutable 

MATCH tag == 0x00000420; 

TYPE GenericlargExecutable 

MATCH tag == 0x00000001; 

TYPE ttyOutlargExecutable 

MATCH tag == 0x00000601; 

TYPE ttyLaunchOut3argExecutable 

MATCH tag == 0x00000703; 

TYPE tty2argExecutable 

MATCH tag ~ 0x00000402; 

TYPE Generic2argExecutable 

MATCH tag ~ 0x00000002; 

TYPE ttyLaunchOut2argExecutable 

MATCH tag — 0x00000702; 

TYPE Generic3argExecutable 

MATCH tag == 0x00000003; 

TYPE ttyLaunchlargExecutable 

MATCH tag == 0x00000501; 

TYPE Launchl-NargExecutable 

MATCH tag == 0x00000120; 

TYPE Launch2argExecutable 

MATCH tag == 0x00000102; 

TYPE LaunchlargExecutable 

MATCH tag ~ 0x00000101; 
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Software developers are free to make use of these predefined TYPEs for 
IRIX utilities that do not require a personalized look. For applications and 
other executables for which a personalized icon is desired, you should create 
your own tag numbers (taking care not to use any of those predefined by 
Silicon Graphics, Inc.) and appropriate MATCH and ICON rules. Other 
rules can be copied from appropriate TYPEs in the list above. 

See the tag(l) man page in Appendix B, " Workspace Man Pages", for 
more information on tagging executables. 



2.2.4 Using Scripts without Tagging 

If you have a generic shell script that you would like to run in a tty window, 
but don't want to create a file typing rule for it, you can do so by making the 
second line of the script look as follows: 

#winterm 

You can also use any of the available flags to winterm (see winterm(\) in 
Appendix B) on this line. 



2.3 The LEGEND Rule 



Syntax: LEGEND text-string 

Description: text-string is a string that describes the file type in plain 
language a user can understand. The legend is used to 
describe the file in the Get File Info window. It is also used 
when a Directory View window is set to display as a list. 
Legends that are longer than 25 characters might be truncated 
in some circumstances. 

Example: LEGEND C program source file 
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2.4 The SUPERTYPE Rule 



Syntax: SUPERTYPE type-name [type-name ... ] 

Description: The SUPERTYPE rule is used to indicate that a particular 
file type can be treated as a part of a more general file type 
under certain conditions. A special case in Workspace is 
directories; you might wish to create a directory with a 
custom icon, yet still have the OPEN and ALTOPEN rules 
work as a normal directory. (Note: Workspace automatically 
handles the OPEN and ALTOPEN rules for directories; the 
OPEN and ALTOPEN rules are place holders.). You could 
create your own directory TYPE with its own ICON rule, but 
if you use SUPERTYPE, it will work like a standard 
directory (see example). SUPERTYPE is also very useful for 
printing, where you might want to print a custom file type as, 
say, an ASCII file. You can also make use of SUPERTYPEs 
in your own OPEN, ALTOPEN, DROP, and PRINT rules by 
using isSuper(l) as part of those rules. See the isSuper{\) 
man page in Appendix B, "Workspace Man Pages". A 
given file typing rule may contain several different 
SUPERTYPE rules, and thus be considered a subset of 
several more general file types. The SUPERTYPE rule does 
not reflect true object-oriented typing, and hence, does not 
allow inheritance of rules; it is more a way of aliasing 
TYPES. 

Example: TYPE MyDiractory 

SUPERTYPE Directory 



( 



2.5 The SPECIALFILE Rule 



Syntax: SPECIALFILE 

Description: SPECIALFILE is used to distinguish a file typing rule used 
for matching non-plain files. Device files, and other non- 
plain files can cause damage to physical devices if they are 
matched using standard file typing rules. Special files are 



c 
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matched using only rules containing SPECIALFILE, which 
are written so as not to interfere with actual physical devices. 
Similarly, plain files are not matched using rules containing a 
SPECIALFILE rule. 



Example: specialfile 



2.6 The Command (CMD) Rules 

The CMD rules determine how an icon behaves when a user interacts with 
it, whether it is by clicking, dragging, or through menu selections. 



2.6.1 The CMD OPEN Rule 



Syntax: CMD OPEN $h-expression[\ sh-expression\ ... ; sh- 

expression] 

Description: The OPEN rule is invoked when any file of the appropriate 
type is double-clicked, or selected and opened from the 
Workspace or Directory View menu via the "Open" menu 
item. The OPEN rule should reflect the most often used 
function that would be applied to a file of the given type. 
sh-expression can be any valid Bourne shell expression. Any 
expression can use multiple lines. Any number of 
expressions can be used, and must be separated by 
semicolons (;). The final expression should not end with a 
semicolon. Variables can be defined and used as in a Bourne 
shell script, including environment variables. See Appendix 
A, * 'Workspace Environment Variables", for a list of special 
environment variables set by the Workspace. These 
environment variables can be used to refer to the currently 
selected icons within the Workspace or Directory View. 

Example: cmd open $wineditor $files 
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2.6.2 The CMD ALTOPEN Rule 



Syntax: CMD ALTOPEN sh-expression[\ sh-expression; ,. 

expression] 



sh- 



Description: The ALTOPEN rule is invoked when any file of the 

appropriate type is double-clicked while the ALT key is 
pressed. The ALTOPEN rule provides added functionality 
for power users, sh-expression can be any valid Bourne shell 
expression. Any expression can use multiple lines. Any 
number of expressions can be used, and must be separated by 
semicolons (;). The final expression should not end with a 
semicolon. Variables can be defined and used as in a Bourne 
shell script, including environment variables. See Appendix 
A, ' 'Workspace Environment Variables" for a list of special 
environment variables set by Workspace. These 
environment variables can be used to refer to the currently 
selected icons within the Workspace or Directory View. 

Example: CMD ALTOPEN make 



2.6.3 The CMD DROP Rule 



( 



Syntax: CMD DROP sh-expression[\ sh- expression; ...; sh- 

expression] 

Description: The DROP rule is invoked whenever a selected (file) icon is 
"dropped" onto another icon in the Workspace or Directory 
View windows. When this happens, Workspace checks to 
see if the file type that is being dropped upon has a DROP 
rule to handle the files being dropped. In this way, you can 
write rules that allow one icon to process the contents of 
other icons simply by dragging selected icons that you want 
processed on top of the target icon (i.e., the one with the 
DROP rule). 

Example: cmd drop $target $selected 
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2.6.4 The CMD PRINT Rule 



Syntax: CMD PRINT sh-expression[\ $h-expre$sion; ... ; sh- 

expression] 

Description: The PRINT rule is invoked whenever a file of the appropriate 
type is selected and printed using the * 'Print' ' menu item 
from the Workspace or Directory View menu, sh-expression 
can be any valid Bourne shell expression. Any expression 
can use multiple lines. Any number of expressions can be 
used, and must be separated by semicolons (;). The final 
expression should not end with a semicolon. Variables can 
be defined and used as in a Bourne shell script, including 
environment variables. See Appendix A, "Workspace 
Environment Variables", for a list of special environment 
variables set by Workspace. These environment variables 
can be used to refer to the currently selected icons within the 
Workspace or Directory View. The recommended method of 
implementing the PRINT rule is to use the Workspace's 
print-job routing utility, routeprint. See the routeprint(\) 
man page in Appendix B, "Workspace Man Pages", for 
details on its syntax. 

Example: CMD PRINT routeprint $LEADER $REST 



2.7 The MENUCMD Rule 



Syntax: MENUCMD "string" sh-expression[\ sh-expression; ... ; sh- 

expression] 

Description: MENUCMD inserts the menu entry string into the 

Workspace or Directory View menu if a single file of the 
appropriate type is selected, or a group all of the same 
appropriate type is selected. If the menu entry is chosen, the 
actions described by the sh-expressions are performed on 
each of the selected files. 

Example: MENUCMD "Empty Dumpster" \rm -rf $LEADER/* 
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2.8 The BOUNDS Rule 



Syntax: 



BOUNDS xO,yO,xl,yl 



Description: xO, yO, xl , yl define, respectively, the lower left and upper 
right corners of the bounding rectangle of the coordinate 
space in which the icon is displayed. The values are 
separated by commas (,). When the Workspace paints the 
icon, it scales the icon so that its bounds fit just within the 
fixed layout area reserved for it. The aspect ratio of the 
bounding rectangle is preserved. If no BOUNDS rule is 
supplied for a file type's icon, the bounding rectangle 
defaults to o.o, o.o, 100.0, 100.0. 

Example: bounds -20.0, -20.0, 50.0, 75.0 



( 



(50,75) 




(55,55) 



C 



pixels 



(-20,-20) 



icon coordinates 



Figure 2-1. Mapping Icons to Pixels Using BOUNDS 
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2.9 The ICON Rule 



Syntax: ICON icon-description-routine 

Description: icon-description-routine is a routine written using the icon 
description language, detailed below. The routine can 
continue for any number of lines. The ICON rule is invoked 
any time a file of the specified type needs to be represented in 
the Workspace or a Directory View. The rule is evaluated 
each time the icon is painted by the application that needs it. 



Example: icon 



color (iconcolor) ; 
bgnoutlinepolygon () ; 

vertex (0, 0) ; 

vertex (0, 60) ; 

vertex (40, 60) ; 

vertex (40, 0) ; 
endoutlinepolygon (outlinecolor) ; 



2.9.1 The Icon Description Language 

The icon description language is a restricted subset of the C programming 
language, including line and polygon drawing routines from the IRIS 
Graphics Library™. The description routine for a given icon is similar in 
structure to a C subroutine, but lacks the subroutine and variable 
declarations and the outermost enclosing brackets. The valid symbols and 
functions in the icon description language are described below. 



Operators 

The following C language operators can be used in an icon description 
routine: 

+ - * / & | A ! % = (){} 

The following C language conditional operators can be used in an icon 
description routine: 

&& II ==!=<> <= >= 
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Constants 

The following logical constants can be used in an icon description routine: 

true false 

The following icon color constants can be used in an icon description 
routine: 

iconcolor outlinecolor shadowcolor 

Use of the icon color constants is described in Section 2.9.2, "Drawing 
Icons 9 '. 



Variables 

The following icon status variables are set by Workspace, and can be used 
in an icon description routine: 

current disabled opened located selected i 

These variables have values of either true or false. They can be used in a 
conditional statement to alter the appearance of an icon when it has been 
manipulated in various ways from the Workspace (see Section 2.9.2, 
"Drawing Icons")- 

Other legal C variables can be used in an icon description routine without 
need of a declaration; all variables are represented as type float. Any 
variable name is acceptable, provided it does not collide with any of the 
predefined constants, variables, or function names in the icon description 
language. 



Functions 

The icon description functions comprise, for the most part, a very restricted I 
subset of the C language version of the IRIS Graphics Library, modified for ^ 
2-D drawing. Table 2-5 describes the set of valid icon description functions. 
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Function Syntax 



Definition 



arc (x, y, r, startang, endang) 

arcf (x, y, r, startang, endang) 
bclos (color) 
bgnclosedline () 

bgnlineO 
bgnoutlinepolygon 



bgnpoint () 



bgnpolygon () 



color (n) 
draw(jt, y) 

endclosedline ( ) 



Draw an arc starting at icon coordinates x, y, 

radius r, starting at angle startang, ending at 

angle endang. Angle measures are in tenths 

of degrees. 

Like arc, but filled with the current pen 

color. 

Like pclos (see below) but uses color for 
the border (outline) color of the polygon. 

Begin drawing a closed, unfilled figure 
drawn in the current pen color. Used in 
conjunction with vertex and 

endclosedline. 

Like bgnclosedline, except the figure 
is not closed. Used in conjunction with 
vertex and endline. 
Begin drawing a polygon filled with the 
current pen color. The polygon is outlined 
with a color specified by 
endoutlinepolygon. Also used in 
conjuction with vertex. 

Begin drawing a series of unconnected 
points defined using calls to vertex. 
LTsed in conjunction with vertex and 
endpoint. 

Like bgnoutlinepolygon except the 
polygon is not outlined. Used in 
conjunction with vertex and 
endpolygon. 

Set current pen color to color index n. 

Draw a line in the current color from the 
current pen location to x, y. 

Finish a closed, unfilled figure started with 

bgnclosedline. 



Table 2-5. Icon Description Functions 
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Function Syntax 



Definition 



endline () 



endoutlinepolygon (color) 



endpoint () 

endpolygon () 

for 

if (expr) expr [ else expr ] 

move (x, y) 

pclos () 



pdrU.y) 

pmv(*,y) 

print (expr or "string" ) 

vertex (x,v) 



Finish an open, unfilled figure started with 

bgnline. 

Finish a filled polygon started with 
bgnout linepolygon and outline it with 
color. 

Finish a series of points started with 

bgnpoint. 

Finish a filled, unoutlined polygon started 
with bgnpolygon. 

Standard Cfor-loop. 

Standard C language if-statement. 

Move current pen location to x, y. 

Draw a line in the current pen color that 
closes the current polygon, and fill the 
polygon with the current color. 

Draw the side of a filled polygon in the 
current pen color, from the current pen 
location to x,y. 

Begin a filled polygon at location x, y. 

print the value of the expression expr or 
string to stdout; used for debugging. 

Specify a coordinate used for drawing 
points, lines, and polygons by bgnpoint, 
bgnline, bgnpolygon, etc. 



c 
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Table 2-5. (continued) Icon Description Functions 



2.9.2 Drawing Icons 



This section describes several concepts that should help you design your 
icons. 

Any points, lines, or polygons you draw will "stack" in the order they are 
drawn, with the most recently drawn polygon on top. You can use this 
concept to easily achieve drop-shadow effects, by drawing the same polygon 
twice, using different pen colors, and offset. 



c 
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Three icon color constants are recommended for standard icon use: 
iconcolor for drawing polygons that make up the * 'foreground' ' of the icon, 
outlinecolor for outlining and linework, and shadowcolor for contrasting 
drop shadows, iconcolor is particularly useful, because it automatically 
changes to the calling application's preferred color conventions when a 
given icon is located, disabled, or selected. 



2.9.3 Style Conventions for Workspace Icons 

The standard set of Workspace icons have been designed to establish a 
clear, predictable visual language for end users. As you extend the 
Workspace by adding your own application-specific icons, it is important to 
make sure that your extensions fit the overall look of the Workspace and 
operate in a manner consistent with the rest of the Workspace. The 
following set of conventions should be followed by developers creating new 
Workspace icons. 



Using World Coordinate Space 

All Workspace icons developed by Silicon Graphics, Inc., lie completely 
within the default world coordinate BOUNDS, a square area 100 units on a 
side. Icons you design can lie within any convenient coordinate space, but it 
is crucial that all points in your icon lie completely within whatever 
BOUNDS you specify. Failure to follow this convention can result in icon 
clipping and other display anomalies. 

In the default configuration of Workspace, any geometry defined for an icon 
within the specified BOUNDS region is mapped into a square screen region 
55 pixels on a side. You should be aware that in other contexts, your icon 
might be mapped onto larger or smaller screen areas, the idea being to 
maintain resolution-independence, which allows an icon to be arbitrarily 
magnified or reduced. Keep in mind that in a 55x55 pixel area, fine details 
are not visible. 



Version 1.0 Writing File Typing Rules 2-19 



Using Icon Colors and Animation 

Use the iconcolor, outlinecolor, and shadowcolor as your icons' typical 
colors; that way, when the icons are selected or located, they will indicate 
that state in a manner consistent with the rest of the Workspace. Be sparing 
with the use of other accenting colors. This helps preserve the impact of 
color when it is needed. 

Some Workspace icons animate when they are double-clicked; directory 
folders open, ASCII text files glow, and executables have the "flying 
carpet' ' whisked out from under them. If you wish to animate your icon 
when it is opened, you can easily do this by having a set of geometry for the 
open state defined within a conditional: 

ICON if (opened) { 

...drawing routines for opened icon... 

} else { 

...drawing routines for unopened icon... 
} 

Since a redraw of each icon's bounding area is done only when it changes 
between its closed and opened states, you should refrain from animating an 
icon for anything other than the * 'opened' ' state. 

Drawing Hints 

When designing your icons, do not use concave polygons; they are not 
currently supported by the icon description language, and using them will 
yield unpredictable results. If your icon does not display as you planned, 
check for concave polygons. You will need to break any such polygons into 
two or more convex polygons (see Figure 2-2). In addition, no single 
polygon can contain more than 255 vertices. 



c 
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Figure 2-2. Splitting a Concave Polygon 

To help keep icon descriptions simple, you are encouraged to use 

bclos (outlinecolor) when possible, in place of a pclos () filled area 

outlined by further calls to moved and draw(). 

bclos (outlinecolor) automatically draws outlined polygons, thus 
shortening icon code and improving performance. Remember to comment 
your icon code generously, in case you want to alter parts of it later. 



Keeping the 3-D Look 

Icons created by Silicon Graphics, Inc., were designed in an isometric space, 
which provides an illusion of 3D, even though the polygons composing the 
icons are 2-D. To generate this effect, draw "horizontal" lines so that they 
move up 1 unit in the y-axis for every 2 units they extend along the true x- 
axis (see Figure 2-3). 
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Figure 2-3. 3-D Icon Axes 
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Designing Icons for Applications 

If you are designing an icon for an application, use the ICON rule for 
GenericExecutable as a base to extend from, adding iconography to the 
basic ' ' flying carpet' ' look. The icon used by jot is a good example of such 
an extension. You can find the ICON rule for GenericExecutable in the file 
lusrlliblfiletypeldefaultlsgidefaultftr. See Figure 2-4 for a representation of 
the GenericExecutable icon. Similarly, your application's data files should 
be modeled using the ICON rule for AsciiTextFile as a base. This rule can 
also be found in the file sgidefaultfir. 



( 




Figure 2-4. GenericExecutable Icon 



2.10 Compiling FTR Rules 

New FTR rules must be compiled from the FTR source files located in a set 
of directories in lusrlliblfiletype. Any time you add or change FTR rules (or 
print conversion rules) within these subdirectories, you must recompile the 
complete set of fir files. This is done by performing the following 
command line sequence: 

su 

ed /usr/lib/filetypa 

make 



Note: When distributing and installing your application and its FTR files 
on a new machine, be sure your installation process copies the FTR 
files into I usrllihljiletypel install and then remakes the FTR file set 
using the procedure described above. 
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Be sure to quit any currently running version of Workspace, and restart it 
afterwards to activate the new FTR rules. 



2.10.1 Order of Precedence of FTR Files 

FTR source files in the following four directories are compiled in the order 
listed here: 

1 . lusrl lib) filetypel local 

2. lusrl lib/ filetypel 'install 

3 . lusrl lib/ filetypel system 

4. lusrl lib/ filetypel default 

Since compiled rules are scanned sequentially by Workspace, a TYPE 
defined in local will override any subsequently defined TYPE with an 
identical type-name. Care should be taken so as not to so override 
important system or default TYPE declarations. 

Within each directory, separate FTR source files are compiled 
alphabetically. 



2.10.2 Placement of FTR Rules 

The default and system directories in lusrl lib/ filetype are reserved for 
systemwide standards and maintained by Silicon Graphics, Inc. Developers 
and users should not place their fir files in these directories. 

The install directory should be used by applications developers and site 
maintainers for integrating their extensions. The standard naming 
convention for application vendors' file typing rules is: 

vendor-name[ . application-name] . f t r 

The local directory may be used by power end-users for personal 
customizations. 
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3. Writing Print Conversion Rules 



Print conversion rules are similar in structure to file typing rules, and in fact 
both can occupy the same FTR files. While file typing rules declare and 
define valid types of files, print conversion rules provide a means of 
generating command pipelines that process a file for printing. Using 
routeprint(l) in a file type's CMD PRINT rule (see Section 2.6.4, "The 
CMD PRINT Rule") causes Workspace to scan each existing FTR file in its 
rule path for a set of one or more rules that, when strung together will result 
in a printed copy of the file. If the rules are written properly, the end result 
is a printed copy of the file. 



3.1 The Print Conversion Pipeline 

Sometimes, converting a file to printable form may take more than one step. 
For example, an nroff file must first be converted to a PostScript® file 
before it can be printed by a laser printer. You could write a single rule that 
would print your nroff 'file directly, but since PostScript files can originate 
from sources other than nroff, you would want instead to write two separate 
rules — one that converts from nroff to PostScript format, and one that 
converts from PostScript to the printed file. This idea of multi-step 
conversion to printable form is called the print conversion pipeline. The 
print conversion rules are designed to take advantage of this method of 
processing printable files. 

Note that when a file is processed along the print conversion pipeline, the 
original file remains intact. The print conversion pipeline is really just a 
series of IRIX commands that process a copy of the file's data in modular 
increments. 
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3.2 The CONVERT Rule 



Syntax: CONVERT source-type-name destination- type-name 

Description: source-type-name is the file type you are converting from. 
destination-type-name is the file type you are converting to. 
If the CONVERT rule is the last in the print conversion 
pipeline (i.e., the rule that actually converts the file to printed 
form), then destination-type-name should be one of the 
printer types defined in the FTR rules (see Section 3.5, 
' 'Printer Types"). All print conversion rules following a 
CONVERT rule apply to that conversion, until another 
CONVERT rule is encountered. 

Example: CONVERT NroffFile PostScriptFile 



c 



3.3 The COST Rule 



Syntax: 



COST non-negative-integer 



Description: non-negative-integer represents the arc cost, or incremental 
cost of the conversion. This is an abstract notion that can be 
used to determine the preferred printer for a particular 
document. This rule is primarily for use in a network in 
which there are many different printers of various quality. 
When routeprint selects a printer, it takes the arc costs into 
account, choosing the print conversion pipeline (see Section 
3.1 "The Print Conversion Pipeline") with the least total 
cost. The COST rule is optional; if it is omitted, the cost of 
the conversion is assumed to be zero. 

Example: cost i 



( 



c 



3-2 Programming the IRIS Workspace 



IR1S-4D Series 



3.4 The FILTER Rule 



Syntax: 



FILTER filter-expression 



Description: The FILTER rule represents part of an IRIX pipeline that 
prepares a file for printing, filter-expression can be any 
single IRIX command line, and generally takes the form of a 
number of piped commands. In the general case, the first 
command within a single FILTER rule receives input from 
stdin; the last command in the rule send its output to stdout. 
routeprint concatenates all the FILTER rules in the print 
conversion pipeline to form one continuous command that 
sends the selected file to its destination printer. 

There are three special cases in creating FILTER rules: 

• first case 

• last case 

• setvarcase 

In the first case, the FILTER rule is the very first rule in the 
print conversion pipeline. In this case, routeprint passes the 
list of selected files to the first command in the FILTER rule 
as arguments. If a first case FILTER rule begins with a 
command that does not accept the files in this fashion, you 
should prepend the cat command to your rule: 



FILTER 



cat | tbl 



| psrof f -d$CURRENTPRINTER 



The files will then be piped to the next command's stdin. 

In the last case, the FILTER rule is the very last rule in the 
print conversion pipeline. At the end of this rule will be a 
command that sends output to a printer (such as Ip). 
routeprint sets the environment variable 
$CURRENTPRINTER to the currently selected printer. Use 
this variable in FILTER rules that require a print destination 
(see example below). See Section 3.6, "The Current 
Printer' ' for more information on how $CURRENTPRINTER 
is set. 



Version 1.0 



Writing Print Conversion Rules 3-3 



Note that a one-step conversion pipeline is an example of 
both a first case and a last case FILTER rule. 

In the setvar case, the FILTER rule is used to set an 
environment variable used later in the print conversion 
pipeline. The first CONVERT rule in the example below sets £ 
a variable that defines an nroff macro used in the second rule. V 
In all setvar cases, stdin is passed to stdout transparently. 
Thus, you can include setvar as part of the pipeline in a 
single FILTER rule. 

Example: CONVERT mmNro££Fil@ Nrof fFIl© 
COST 1 
FILTER setvar M&CRO=mm 

CONVERT NroffFil© PostScriptPrinter 
COST 1 

FILTER eqn | tbl | psroff -$M2kCRO 
-d$CURRENTPRINTER 



3.5 Printer Types 

Three printer types are currently supported by the IRIS system. They are 
specified in the FTR file lusrlliblfiletypelsytemlsgisystemfir: 

TYPE ColorPrinter 
TYPE PostScriptPrinter 
TYPE DumfoPr inter 

In most cases you will want to use either PostScriptPrinter (for text or 
images) or ColorPrinter (for images only) in your CONVERT rules. 
DumbPrinter supports standard line printer text-only output. 



( 
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3.6 The Current Printer 

The current printer is the system default printer set by the user with the Print 
Manager, or, alternatively, with the -p option to routeprint. If no default is 
set and -p is not used, an error message will be returned by routeprint to 
either stdout or a notifer window (if the -g option to routeprint was set). 
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4. Creating Workspace Templates 



Workspace templating provides a means of making sure that all the 
applications and/or files a user will need appear in the Workspace window 
whenever Workspace is started up. It also provides a way of limiting naive 
users' access to sensitive directories by "locking" those directories out of 
the Workspace. 

Workspace templates are set interactively by invoking a special flag to 
workspace from the shell. 



4.1 Using Workspace in Template Mode 

To use the Workspace in template mode, you must first quit Workspace if 
you are using it. Open a shell window, and type the following commands: 

su 
workspace -t 

You may optionally specify a name after the -t option (see workspace(l)). 
This name determines the name of the template file; by default it is set to 
your login name ($USER). The name option is useful for developers who 
might want to identify their Workspace templates by the name of their 
product or company. 

You should run Workspace in template mode when logged in as a typical 
user in order to get a template that represents an environment in which a 
typical user would work. You should not run Workspace in template mode 
when logged in as "root", for example, because its home directory is in an 
unusual location. Note that you must, however, invoke root privileges to 
run Workspace in template mode, but in this case, the original login 
environment is preserved by Workspace. 
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When Workspace comes up, it will look identical to your non-template 
mode Workspace. The only difference is the addition of four items to the 
Workspace menu: 

• Save Template 

• Get Root 

• Set Lock On 

• Set Lock Off 

These functions are explained below. 



Save Template 

The Save Template menu item saves your Workspace template to a file with 
the following format: 

name. wsrc 

name is either the name you specified when invoking Workspace from the 
command line (described above), or $USER by default. When you use the 
Save Template command, Workspace will first attempt to write the 
template file to the directory I u$r I lib/workspace. If you do not have 
permission to write to that directory, Workspace will offer you the option of 
creating that file in your own Workspace directory. In this case, you will 
need to install your new template file in I usr I lib/workspace before other 
users can access it. If more than one Workspace template exists in this 
directory, Workspace will use all of the templates, in an additive manner. 
Developers should plan on installing their templates into this directory on a 
user's machine as part of their installation process. 

Get Root 

Under normal circumstances, the root (/) directory cannot be removed from 
the Workspace. Workspace in template mode allows you to remove the | 

root directory and limit access from the Workspace to other directories (see ^ 
* ' Set Lock On/Off \ below). The Get Root menu item lets you retrieve the 
root directory and place it back in the Workspace window once it has been 
put away. 
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Set Lock On/Off 

The Set Lock On and Set Lock Off menu entries allow you to limit the 
user's access to the IRIX file system from the Workspace. When a 
directory is locked using the Set Lock On menu item, a user cannot access 
any file or directory that is in a parent directory, or is itself a parent directory 
of the locked directory, unless it is already in the Workspace window. To 
lock a directory, select it and choose the Set Lock On item from the 
Workspace menu. 

The Set Lock Off menu item unlocks a locked directory. Locked directories 
cannot be put away from the Workspace using the Put Away menu item; 
they must first be unlocked. The root (/) directory is, by default, locked; all 
other directories are initially unlocked. If you unlock and put away root, you 
should choose another directory to be the head of the subtree, and set a lock 
on it. If you choose to lock a directory other than root (/), you must put 
away any ancestors of that directory before you save the template, or they 
will appear on the user's Workspace. 



4.2 Setting Up an Application Environment 

By using the four menu items described in the last section along with the 
standard workspace features, you can create a template for the Workspace 
window that provides your users with all the necessary icons (files) to use 
whatever application you are developing. You can place the application 
directly in the Workspace window so that your users will not have to 
rummage through directory views to find it. Likewise, you can place 
utilities and directories customized with your company logo there. Using 
the Set Lock... items and the Put Away item, you can limit naive-user access 
to the root directory and other directories that might contain data to which 
end users should not have direct access. 



Version 1 .0 Creating Workspace Templates 4-3 



( 



( 



a 



5. Creating Transfer Devices 



Transfer devices are special executable shell scripts that allow users to 
import and export data from a directory. Transfer devices selected using the 
Transfer Manager tool install themselves in the Workspace and Directory 
View menus as items in the Transfer submenu. Once installed using the 
Tranfer Manager, a transfer device is accessible from the Workspace or any 
Directory View menu. 



5.1 The Tranfer Device Interface 

Transfer Devices are shell scripts that communicate with the Workspace 
and the Transfer Manager through a simple set of protocols. They are 
installed by placing them in the directory /etc/transferDevice; any script in 
that directory that follows the protocol described below will appear as an 
icon in the Transfer Manager. 



5.1.1 Transfer Device Typing 

The second line of a transfer device script (the line after the shell 
invocation) must have the following form: 

#transferDevn<zm£ 



name can be any name addition to the ' 'transferDev' * prefix. The complete 
name (tmnsfcrDev name) should correspond to a TYPE declaration in an 
FTR file. The Transfer Manager scans the set of file typing rules for this 
TYPE, and uses the associated ICON rule to draw the transfer device's icon 
within the Transfer Manager window. 
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When creating new transfer devices, you should write your own FTR rules, 
using the rules for standard shipped transfer devices as templates. If you do 
not do so, a generic transfer device icon will be assigned to the transfer 
device. 



5.1.2 Transfer Device I/O 

A transfer device must be able to handle the following strings as arguments. 

• menu 

• versionsOK 

The meaning of these strings, and the output that is associated with them, is 
explained in the following two sections. 

menu 

The transfer device is called with this argument by both the Workspace and 
the Transfer Manager. The transfer device must respond by echoing one or 
more character strings in the following format: 



i ch o " tokenl menu- item- string 1 ' ' 
: cho " token! menu- item-string! " 



tnenu-item-string is the text of the menu item that you wish to appear in the 
Transfer submenu of the Workspace and Directory View menus. These 
items will only appear once the transfer device as been set by the user with 
the Transfer Manager. A transfer device may insert any number of menu 
items. 

token is a one- word, unique token that Workspace will use as an argument 
in calling the transfer device when its associated menu item is chosen from 
the Transfer submenu. Thus, your transfer device must also accept each 
token string as an argument, and respond with the appropriate action 
described in its associated menu item. 
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versionsOK 

When a user tries to set your transfer device using the Transfer Manager, the 
device is called with "versionsOK" as an argument. Your device must 
echo one of the following strings: 

echo "local" 

echo "remote" 

echo "remote local" 

If it echoes the first string, the Transfer Manager will allow only the local 
version of the device to be set. If it echoes the second string, only remote 
versions of the device can be set. If it echoes the last string, either version 
can be set. 



5.1.3 Using Workspace Environment Variables 

Currently, only the Workspace environment variable $SELECTED is 
supported for use within transfer devices. This variable contains the list of 
selected icons from the Workspace. See Appendix A, "Workspace 
Environment Variables", for more information. 



5.1.4 Local Transfer Devices 

You can make a transfer device available to a particular user, but not all 
users by placing the transfer device in the user's 
$HOMEI,work$pacellocalTransferLinks directory. It will appear in the 
Transfer Manager window just like any other transfer device, but only when 
the window system is started from that particular user's login. 



5.2 Example: shellDevice 



The following is an example transfer device that allows you to open a shell 
window on any selected directory. Note that this transfer device inserts only 
one menu item in the Transfer submenu. Transfer devices can insert any 
number of items into the Transfer submenu. 
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Make sure to set the device's execute permissions. 



#!/bin/5h 

#transferDevShell ■■■,■..'. 

# User Preference Variables: 
# true or false 
openMultiple=false 

case $1 
in 

"menu") 

echo "open Open a Shell Window" 

"versionsOK") 

echo "local" 

"open") 

if [ -z "$SELECTED" ]; then 

# Workspace puts us in the correct directory. 
title=*pwd* 

winterm -t $title 
else 

# Check that the user has made a valid 

# number of selections, 
set — $ SELECTED 

if [ $openMultiple = false -a $# -gt 1 ] ;' then 

inform "Too many selections; cannot open shell, 
exit 1 

fi 

# Go to the proper directory and open the window, 
for selection in $SELECTED; do 

if [ -d $selection ] ; then 

cd $selection 
else 

dir =,1 dirname $selection s 
cd $dir 
fi 

title= *pwd^ 
winterm -t $title 
done 
fi 

esac 
exit 



C 
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Appendix A: Workspace 

Environment Variables 



The following is a list of environment variables used by Workspace. Any 
of these variables can be used as part of the OPEN, ALTOPEN, or PRINT 
file typing rules, or as part of the FILTER print conversion rule. 



$LEADER 



$REST 



$LEADERTYPE 



$RESTTYPE 



$RESTTYPELIST 



If one or more icons are currently selected from 
the Workspace, LEADER is set to the icon 
whose text field is highlighted. If no icons are 
selected, it is set to null. 

If more than one icon is currently selected from 
the Workspace, REST contains the list of names 
of all selected icons except the highlighted icon 
(see LEADER above). Otherwise, it is set to 
null. 

If one or more icons are currently selected from 
the Workspace, LEADERTYPE is set to the 
TYPE of the icon whose text field is highlighted. 
If no icons are selected, it is set to null. 

When more than one icon is currently selected 
from the Workspace, RESTTYPE contains the 
TYPE for all selected icons except the 
highlighted icon, if the remainder of the selected 
icons are all the same TYPE. If they are not the 
same TYPE, or only one icon is selected, 
RESTTYPE is set to null. 

Contains the list of TYPEs corresponding to the 
arguments in REST. If only one icon is selected, 
RESTTYPELIST is set to null. 
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$ARGC 
$TARGET 

$TARGETTYPE 

$SELECTED 
$SELECTEDTYPE 

SSELECTEDTYPELIST 
SWINEDITOR 



$WINTERM 



Contains the number of selected icons. 

Set only for the CMD DROP rule, TARGET 
contains the name of the icon being dropped 
upon; otherwise it is set to null. 

Set only for the CMD DROP rule, 
TARGETTYPE contains the TYPE of the icon 
being dropped upon; otherwise it is set to null. 

Contains the names of the icons being dropped 
on TARGET, or null, if none are being dropped. 

If all the icons named in SELECTED are of the 
same TYPE, SELECTEDTYPE contains that 
TYPE; otherwise it is set to null. 

Contains a list of TYPEs corresponding to the 
TYPEs of the selected icons named in 
SELECTED. If only one icon is selected, it is set 
to null. 

Contains the name for the text editor invoked 
from Workspace. The default editor is jot. To 
use an editor that does not generate its own 
window by default, you must set WINEDITOR to 
the appropriate winterm command line sequence. 
Thus, for vU you would set WINEDITOR as 
follows: 

setenv WINEDITOR r winterm -c vi r 

Contains the name of the window terminal 
invoked from Workspace using wintertnil). 
Currently supported window terminals are wsh, 
psterm, and xterm. The default window terminal 
is wsh. 
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Appendix B: Workspace Man Pages 



The following table lists the IRIX man pages found in this manual. 



Man Page 


Synopsis 


confirm(lG) 


displays a message in a window with a 
choice of responses 


dirview(lG) 


graphical interface to a directory 


inform(lG) 


displays a message in a window 


isSuper(l) 


checks if a given TYPE is of a given 
SUPERTYPE 


Jot(lG) 


a simple mouse-based editor; the default 
editor accessible from Workspace 


launch(l) 


puts up a window that prompts to complete 
the command line of an executable 


routeprint(Y) 


routes files to printers using Workspace 
print conversion rules 


tag(l) 


tags a MIPS executable with a magic 
number; for use in file typing 


winterm(l) 


helps launch applications that require a 
terminal emulator 


workspace(\G) 


the Workspace visual interface 



Table B-1. Workspace Man Page Summary 
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CONFIRM(IG) Silicon Graphics CONFIRM(IG) 

NAME 

confirm - display a message in a window and request a response 

SYNOPSIS 

confirm [ -b button-name ... ] [ -t "title-string" ... ] 

DESCRIPTION 

confirm displays a window containing a line of test for each -t argument 
specified, and a button for each -b argument specified. When one of the 
buttons is pressed, the label of that button is written to confirm! s standard 
output. This allows shell scripts to ask questions. 

EXAMPLE 

The following shell script will display a window, asking the user a yes or no 
question. 

#! /bin/sh 

case ^confirm -t "Really power down the computer?" -b No -b Yes * 

in 

Yes) shutdown ;; 

No) ;; 
esac 



BUGS 



There can be at most threee lines of titles specified with -t and three but- 
tons specified with -b. 

The window which appears is fixed size, and the text is not wrapped, so a 
lengthy message can be truncated. 

The buttons are of fixed size, so lengthy button titles will not fit on the but- 
tons. 



SEE ALSO 

inform(lG) 
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DIRVIEW(IG) Silicon Graphics DIRVIEW(IG) 

NAME 

dirview - graphical interface to file system 

SYNOPSIS 

dirview pathnames 

dirview -o sourcename targetname 

DESCRIPTION 

dirview is a tool which allows quick access to a directory view not currently 
open on the Workspace. When invoked with a directory path name, it will 
request an existing Workspace process to open a directory view of that 
directory. If no Workspace process exists for that user, dirview will start 
one. 

dirview accepts the following options. 

pathname [pathname...] 

If dirview is run with one or more directory pathnames as argu- 
ments, a view will be opened for each of those directories. 

-o sourcename targetname 

If a view is open for sourcename, replace it with a view of target- 
name, sourcename and targetname can be either full or relative 
path names. 

SEE ALSO 

workspace(lG) 

Programming the IRIS Workspace 
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INFORM(IG) Silicon Graphics MFORM(IG) 

NAME 

inform - display a message in a window 

SYNOPSIS 

inform [text] 

DESCRIPTION f 

inform opens up a window on the graphics console containing the text and a ^ 
Continue button. If the mouse is clicked in the Continue button, the win- 
dow will go away. 

BUGS 

The window which appears is fixed size, and the text is not wrapped, so a 
lengthy message can be truncated. 

SEE ALSO 

confirm(lG) 
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XSSUPER( 1 ) Silicon Graphics ISSUPER( 1 ) 

NAME 

isSuper - supertype checking utility for use with file type rules 

SYNOPSIS 

isSuper supertype testtype [file.ctr] 

DESCRIPTION 

isSuper is used to check if testtype has a supertype of type supertype 
defined in the .ctr file file.ctr or a default of lusrlliblfiletypelworkspace.ctr. 

SEE ALSO 

Programming the IRIS Workspace 
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JOT( 1G) Silicon Graphics JOT( 1G) 

NAME 

jot - a simple mouse-based text editor 

SYNOPSIS 

jot [ -f fontname] [files...] 

DESCRIPTION 

jot is a simple editor that uses the mouse to cut, copy, and paste text, and to 
position the cursor, jot also allows you to perform simple searches. 

If you specify the -f option followed by a font specification, jot will use the 
specified font to display the text. For example: 

jot -f Courierl4 

opens a. jot window with a 14-point Courier font. 

If you specify a set of text files separated by spaces on the command line, 
jot will open that file for editing; otherwise it will open a new file. 

The jot menu provides the following facilities: 

Cut Remove selected text to the cut buffer. This text can be sent to a 
wsh window or to another jot window, as well as the window it 
was cut from. This function can also be accessed using the F2 
function key on the keyboard. 

Copy Copy selected text to the cut buffer. This text can be sent to a wsh 
window or to another jot window, as well as the window it was 
copied from. This function can also be accessed using the F3 
function key on the keyboard. 

Paste Transfer text from the cut buffer to the current text cursor loca- 
tion (the current point). If text is selected when the paste is made, 
the selected text is replaced with the text from the buffer. This 
text could have been cut/copied from any jot or wsh window. 
This function can also be accessed using the F4 function key on 
the keyboard. 

Search Search the document for the first instance of a string. Choosing 
'Search' generates a notifier window that requests a string, jot 
searches sequentially from the current point through the rest of 
the file for that string, selecting the first instance it comes across. 
To find the next instance, you must choose 'Select' again. 

Open Open a text file. Choosing 'Open' generates a notifier window 
that requests a file name, jot opens a new window with the new 
file in it, keeping the old one open as well. 
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JOT(IG) 



Silicon Graphics 



JOT(IG) 



SELECTING TEXT 

Select text with the left mouse button by performing the following actions: 

click Sets the new current point to wherever the 

mouse (arrow) cursor is pointing in the 
text. 



click-hold-release 



click-click 



shift&click-hold-release 



alt&click-hold-release 



This action selects all text between the the 
point where the left mouse button is first 
clicked down and the point where it is 
released. 

Double-clicking the left mouse causes the 
word over which the mouse cursor is 
clicked to be selected. Double-clicking in 
the margin, or past the end of a line selects 
the whole line. 

If you have already selected a block of text, 
you can extend your selection either for- 
wards or backwards by holding down the 
shift key while clicking the left mouse. 

Same as click-hold-release, except that an 
implicit copy is performed when the left 
mouse button is released. You can use 
alt&shift&click as well. 

SCROLL BARS 

jot uses horizontal and vertical scroll bars with proportional thumbs. 

Clicking on the arrows with the left mouse button causes the jot window to 
scroll one character up, down, left, or right. Holding down the left button 
over any arrow causes the scrolling to auto-repeat. Holding down the shift 
key while clicking on any arrow causes the window to scroll one full page 
of text. 

The scroll bars' thumbs can also be used to scroll through the jot window 
by clicking and holding down the left mouse button while dragging the 
thumb with the mouse cursor. The size of the thumbs are variable, and 
indicate the percentage of total text that is visible in the window. 



BUGS 



The horizontal scrollbar can only handle lines a maximum of 200 characters 
across. 



SEE ALSO 

wsh(lG) 
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LAUNCH(l) Silicon Graphics LAUNCH(l) 

NAME 

launch - graphical utility to enter arguments and invoke commands 

SYNOPSIS 

launch [-h header] [-m message ] [-t trailer ] [-c command] 

DESCRIPTION 

launch is used to invoke commands through a window that contains a text 
edit field to allow for command completion. The options to launch are as 
follows: 

-h header puts the header header on the command that is used to 
invoke the command but is not displayed. 

-t trailer puts the trailer trailer on the command that is used to invoke 
the command but is not displayed. 

-m message displays the message specified by message in the window. 

-c command sets the command invoked to command. 

When no arguments are specified, launch comes up with an empty text field 
waiting for input. 

If the launched program requires a tty, you must call launch with the -h 
option, followed by an appropriate invocation of winterm. The following is 
an example of launch as used with mail. 

launch -h winterm -c mail 

SEE ALSO 

winterm(l) 

Programming the IRIS Workspace 
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ROUTEPRINT( 1 ) Silicon Graphics ROUTEPRINT( 1 ) 

NAME 

routeprint - route file to printer 

SYNOPSIS 

routeprint [-g] [-p printer] [-t type] files 

DESCRIPTION 

routeprint is a utility used by Workspace and accessible from the IRIX 
command line to route files of various types to a set of desired printers. 
routeprint uses file types specified on the command line to look up print 
conversion rules for each file to be printed. The conversion rules are located 
in compiled xtr files in lusrlliblfiletype. The source fir files can be found in 
the local, install, system, and default subdirectories is lusrlliblfdetype. If no 
file types are specified on the command line, routeprint looks up the 
appropriate type for each file, routeprint uses the print conversion rules to 
process the files into a form printable by the target printer. 

printer is the name of a printer to which the output may be sent. 

type is a file-type name. 

files is one or more file names, separated by spaces. 

The -g option should be used when routprint is defined as part of a file typ- 
ing rule. This option puts error messages in a notifier window (instead of 
sending them to stdout) and supresses warnings. 

The -p or -t options may appear multiple times on the command line, and 
are used in the following way: 

-p printer is added to the collection of printers on which the output 

may appear. Each instance of the -p option on the command line 
adds one printer to this collection. If more than one printer is 
specified, routeprint uses the print conversion rules to determine 
the best printer to use. If no printer names are given via the -p 
flag, the destination printer is the system default printer. Using 
the -p option overrules the system default printer. 

-t type sets the file-type for the files that follow it on the command 

line until another type is specified. If no type is given via the -t 
flag, or files appear on the command line before the first -t, the 
files are typed by routeprint. {routeprint does not currently sup- 
port the use of multiple file-types.) routeprint examines all of the 
specified files' types. If they are identical, a single print job will 
be initiated. If the types are varied, routeprint generates an error 
message. 
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CONVERT postscript mylaserprintertype 
COST 1 
FILTER Ip -d $CURRENTPRINTER 



The CONVERT item specifies the file type of the input file followed by the 
file type of the converted file. 
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ROUTEPRINT( 1 ) Silicon Graphics ROUTEPRINT( 1 ) 

The system default printer is the printer or printer class on which a print job 
appears if no printer is specified with the -p option. The system default 
printer is normally specified using the Print Manager in the System tool- 
chest. 

USAGE 

A typical call from Workspace would be from a fir file type rule entry such 
as: 

PRINT routeprint -t $ARGTYPE $FIRSTFILE 
$RESTFILES 

A typical call from the command line might look like the following: 

routeprint -p myprinter filel file2 file3 

JOB ORDERING 

The ordering of files handed to routeprint determines the ordering of files 
within the resultant print job. The ordering of files handed to routeprint 
from Workspace is constructed in the following manner: 

• If an icon is selected individually, its name is appended to the 

current pending selection list. f 

• • ' If an area selection is made, each of the icons within that area 

selection is added to the pending selection list in geographic 
order, left-to-right, top-to-bottom. 

PRINT CONVERSION RULES 

The fir file used by routeprint contains both file type rules and print 
conversion rules. 

The following is a typical set of print conversion rules: 

CONVERT troff_text postscript 
COST 1 
FILTER psroff -t $file 



( 



ROUTEPRINT( 1 ) Silicon Graphics ROUTEPRENTT( 1 ) 

The COST item specifies an arbitrary number between and 100 
(inclusive) that represents the image degradation in printing. The higher the 
COST value, the more routeprint will try to avoid printing by that specific 
conversion method, if it is given a choice. 

The FILTER item contains the shell command that performs the conver- 
sion. 

Given the conversion rules above, the command: 

routeprint -p mylaserprinter -t troffjtext myf ile.trof f 

would cause the file mytroff.t to be printed on the printer named "mylaser- 
printer" via the psroff and Ip commands. Note that more than one conver- 
sion rule may be used to actually get the files into a printable form. 

FILES 

/usr/lib/filetype/local/* .ftr 
/usr/lib/filetype/install/* .ftr 
/usr/lib/filetype/system/*.ftr 
/usr/lib/filetype/default/* .ftr 
$HOME/.workspace/print 

SEE ALSO 

Programming the IRIS Workspace 
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TAG(l) Silicon Graphics TAG(l) 

NAME 

tag - tag a MIPS executable or shell script with an identifying number 

SYNOPSIS 

tag number filename[s] 
tag -c filename[s] 
tag filename 
tag -q filenames 

DESCRIPTION 

tag is used to set, clear or query the tag number in a MIPS executable, or 
shell script that follows the convention of #!/bin/sh or #!/bin/csh on the first 
line. The tag number is used by the SGI Workspace to determine the type 
of a file. 

tag number filename [s] sets the tag number of a MIPS executable or 

script. ( Many executables or scripts can be 
specified to be tagged with the same number.) 
The number must be non-negative and less than 
4294967296. 

tag -c filename[s] clears the tags on the specified file or files. 

tag filename prints out the tag number of a MIPS executable 

or script. 

tag -q filenames prints out the tag numbers of a list of MIPS exe- 

cutables or scripts. 

Tag numbers are administered by the Silicon Graphics user interface group. 
Contact them in order to get a block of tag numbers. 

The tag number is stored as a longword in bytes 68 through 71 (numbering 
from zero) of the MIPS executable. The most significant bit of byte 18 is 
set when the file has been tag and will not be set otherwise. For shell 
scripts, the line '#Tag <number>' will be inserted as the second line of the 
shell script. 

BUGS 

Only shell scripts whose first line is exactly "#!/bin/sh" or "!#/bin/csh", with 
no trailing flags on the first line are recognized by the tag command. 

SEE ALSO 

Programming the IRIS Workspace 
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WINTERM( 1 ) Silicon Graphics WINTERM( 1 ) 

NAME 

winterm - utility to launch applications that require a terminal emulator. 

SYNOPSIS 

winterm [-Hl-f fontl-t titlel-p x,yl-s cols,linesl-c command] 

DESCRIPTION 

winterm is a shell script that presents an abstract command line syntax for 
the user's own terminal emulator. Terminal emulators supported include 
wsh, psterm, and xterm. The user can preset their preferred termulator 
(with preferred options) by setting the environment variable $WINTERM. 
If WINTERM is unset, winterm provides wsh as a default. 

-H holds the winterm open. 

-f font sets the font used by the winterm to font. 

-t title sets the title used by the winterm to title 

-p x,y sets the position of lower left corner of the winterm to x,y. 

-s colsjines sets the size of the winterm to colsjines. 

-c command feeds the rest of the line as the command to execute. Must 
be the last flag set when winterm is invoked. 

NOTES 

The default WINTERM is: WlNTERM='wsh -fScreenll 

-C54, 96, 3,2, 0,50'. 

The -H option is not supported by xterm. 

The -f option is not supported by psterm. 

SEE ALSO 

Programming the IRIS Workspace 
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WORKSPACE( 1G) Silicon Graphics WORKSPACE( 1G) 

NAME 

Workspace - graphical interface to file system 

SYNOPSIS 

workspace [-w] [-t [name]] 

DESCRIPTION 

Workspace provides a graphical, interactive interface to the IRIX file sys- 
tem. This interface is provided via two kinds of views. When invoked with 
no arguments, Workspace opens a window displaying a portion of the IRIX 
file tree, which can be pruned and expanded on a per user basis. The second 
type of view, instantiated by opening a directory icon, provides an con- 
stantly up-to-date representation of that 
IRIX directory. 

Workspace accepts the following options. 

-w Open only the Workspace view (Note that otherwise Workspace 

will start up with whatever views were open the last time it was 
used). 

-t [name] 

Allow the user to create a sample Workspace view, and install it 
in /usr/lib/workspace. If a name is provided after this option, the 
file will be installed in the form name. wsrc. Otherwise, the file 
will be called $USER.wsrc. Each time a new template is added, 
or one is altered, all users on the system will automatically load it 
the next time they start their Workspace. Note that the template 
file will have to be installed manually if this option is run by a 
user without privelege to write into /usr/lib/workspace. 

Note that only one Workspace process can be run for each user. 
If the process is invoked again while it is already running, the 
Workspace window will be either opened or popped to the top. 

SEE ALSO 

dirview(lG) 

Programming the IRIS Workspace 
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ALTOPEN rule, 2-12 

ALTOPEN , 2-2 

application environment, 4-3 

arc cost , 3-2 

arc, 2-17 

arcf.2-17 

ascii , 2-5 



decimal representation, 2-4 
dircontains, 2-5 
disabled, 2-16 
draw, 2-17 
drawing icons, 2-18 
DROP rule, 2-12 
DROP, 2-2 
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bclos,2-17 


endclosedline, 2-17 


bgnclosedline, 2-17 


endline,2-18 


bgnline, 2-17 


endoutlinepolygon, 2-18 


bgnoutlinepolygon, 2-17 


endpoint, 2-18 


bgnpoint, 2-17 


endpolygon, 2-18 


bgnpolygon, 2-17 


environment variables, 


bounding rectangle, 2-14 


Workspace, 2-11, 2-12 2- 


bounding values, 2-14 




bounding values, default, 2-14 




BOUNDS rule, 2-14 
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file icons, 1-1 
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file typing rules, 1-1, 1-2 


file typing rules, summary, 2-2 


char, 2-5 


file typing, 1-1 


color, 2-17 


FILTER rule, 3-3 


compiling FTR files, 2-22 


for-loop, 2-18 


CONVERT rule, 3-2 


FTR files, 1-2 


COST rule, 3-2 




current printer, 3-5 




current, 2-16 




CURRENTPRINTER,3-5 


G 


CURRENTPRINTER,3-3 


Get Root, 4-2 




glob, 2-5 
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hexadecimal representation , 2-4 



mode , 2-5 
move, 2-18 
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icon description conditionals, 2-15 
icon description constants, 2-16 
icon description functions, 2-16 
icon description language, 2-15 
icon description operators, 2-15 
icon description variables , 2-1 6 
ICON rule, 2-15 
icon status variables, 2-16 
ICON, 2-2 

iconcolor, 2-16, 2-19 
if-statement,2-18 
IRIX file system , 1-1 
isSuper(1),2-10 



LEGEND rule, 2-9 
LEGEND, 2-2 
linkcount, 2-5 
located , 2-1 6 
long , 2-5 



octal representation , 2-4 

OPEN rule, 2-11 

OPEN , 2-2 

opened, 2-16 

order of precedence, FTR rules, 2-23 

outlinecolor,2-16, 2-19 



pclos,2-18 

pdr,2-18 

placement of FTR rules, 2-23 

pmv, 2-18 

print conversion pipeline, 3-1 

print conversion rules, 1-2, 3-1 

PRINT rule, 2-13 

print, 2-2 ,2-5,2-18 

printer types , 3-4 
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MATCH rule, 2-3 

MATCH rules, effective, 2-6 

MATCH , 2-2 

match-expression conditionals, 2-4 

match-expression constants, 2-4 

match-expression functions, 2-4 

match-expression numerical 

representation , 2-4 

match-expression operators , 2-4 

MENUCMDrule ,2-13 

MENUCMD.2-2 
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routeprint(l), 2-13i 3-1, 3-3, 3-5 
rule keys, 2-1 



Save Template , 4-2 
Set Lock Off, 4-3 
Set Lock On , 4-3 
shadowcolor, 2-16, 2-19 
short, 2-5 
size , 2-5 

SPECIALFILE rule, 2-10 
SPECIALFILE,2-2 
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string , 2-4 

style conventions, 2-19 

SUPERTYPE rule, 2-10 

SUPERTYPE,2-2 



tag , 2-5 

transfer device I/O, 5-2 
transfer devices, 1-2,5-1 
Transfer Manager, 1-2, 5-1 
transfer scripts , 5-1 
Transfer submenu , 5-1 
TYPE declaration , 2-3 
TYPE, 2-2 
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uchar , 2-5 
ushort, 2-5 



valid match-expressions , 2-4 
vertex, 2-18 
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Workspace Directory View, 1-2 
Workspace templates, 1-2, 4-1 
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